------------------
Description
------
MFACE is a high-resolution model for the aurora field-aligned currents derived from ten years of CHAMP data with a novel technique based on EOF decomposition. Predictor variables include MLat, MLT, DoY, IMF conditions, Vsw and AE index. Compared to existing models, MFACE yields significantly better spatial resolution, reproduces typically observed FAC thickness and intensity, improves on the magnetic local time distribution, and gives the seasonal dependence of FAC latitudes and the NBZ current signature. Our EOF decomposition reveals that EOF1 represents mainly the Bz-controlled large scale R1/R2 current pattern whereas EOF2 represents the By-controlled cusp current signature.
For details cf. 
http://dx.doi.org/10.1029/2012GL053168 
http://dx.doi.org/10.1002/2014JA019776 
http://www.faculty.jacobs-university.de/jvogt/mface/ 
As examples of the output, few movies are avilable at
https://www.youtube.com/user/hquark
------------------
Contents
------
MFACE_v1.m															:  Code of MFACE v1.0
MFACE_30min_Lag_N_v1.0									:  MFACE v1.0 coefficients for the Northern Hemisphere
MFACE_30min_Lag_S_v1.0									:  MFACE v1.0 coefficients for the Southern Hemisphere
AEmodel.mat           									:  model coefficients for AE index
--
MFACE_Example.m                    			: the code of one exmaple
exampleData.mat                        	: the data for the exmaple
MFACE_Example.png                      	: the output of the exmaple
--
FAC_in_the_*_Hemisphere_from_*_to_*.gif : Movie examples for few days
require_MFACE_output.txt								: example message to require MFACE Movies or Figures
��TO REQUIRE SIMILAR MOVIES OR FIGURES FOR ANY SPECIFIC PERIODS PLEASE CONTACT MAOSHENG.
-----------------
Communication to:
-------
Maosheng He
Jacobs University Bremen, 
Campus Ring 1
28725 Bremen, Germany
+49-421-200-3209
m.he@jacobs-university.de  /  hmq512@gmail.com
Sept. 20, 2013 
------------------------
Copyright (c) 2012, Jacobs University Bremen 
All rights reserved. 
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the 
following conditions are met: 
 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the 
following disclaimer. 
 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the 
following disclaimer in the documentation and/or other materials provided with the distribution. 
 
THIS SOFTWARE IS PROVIDED BY JACOBS UNIVERSITY BREMEN "AS IS" AND ANY EXPRESS 
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 
EVENT SHALL JACOBS UNIVERSITY BREMEN BE LIABLE FOR ANY DIRECT, INDIRECT, 
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 